Developer Documentation

QuickTime 4 API Documentation

QuickTime 4 Reference

| Previous | Chapter Contents | Chapter Top | Next |

SMPTE Radial Effects

kRadialTransitionType ('smp3')

This effect is an implementation of the 39 radial effects from ANSI/SMPTE 258M-1993, plus two Apple-defined wipes that choose a random effect. These are a series of radial "reveal" type effects that take place between two sources. For full definitions of these 39 radial effects and what they look like, please refer to the SMPTE documentation.

Example:

The SMPTE radial effects take two sources and seven parameters.

Parameters

Use the descriptions below to help you understand what the parameters do. To learn how to use parameter atoms, see "Adding Video Effects to a QuickTime Movie"

Name

Code

QTAtom Type

Description

Percentage

'pcnt'

kParameterTypeDataFixed

Always a tween

This parameter contains a tween. As the effect progresses, QuickTime renders the frame of the effect indicated by the tween's current value, as a percentage of the whole effect. For example, if the tween goes from 0 to 100, the effect renders completely; if the tween goes from 25 to 75, rendering begins 25% into the effect and terminates 75% through the effect.

Wipe ID

'wpID'

kParameterTypeDataEnum

Contains the SMPTE ID for the effect. By setting this parameter, you control which of the 39 available radial effects is used. See the enumeration list below.

Soft border

'soft'

kParameterTypeDataBitField

If this parameter contains true , the border drawn around the second source is blurred.

Border width

'widt'

kParameterTypeDataFixed

Can be a tween

The width, in pixels, of a border that is drawn around the second source.

Border color

'bclr'

kParameterTypeDataRGBValue

Can be a tween

The RGB color of the border around the second source.

Horizontal repeat

'hori'

kParameterTypeDataLong

Can be a tween

The number of horizontal repeats of the effect that are executed in a single source.

Vertical repeat

'vert'

kParameterTypeDataLong

Can be a tween

The number of vertical repeats of the effect that are executed in a single source.

Wipe ID Enum

The Wipe ID parameter can take the following values:

Value

String

201 Rotating top
202 Rotating right
203 Rotating bottom
204 Rotating left
205 Rotating top bottom
206 Rotating left right
207 Rotating quadrant
211 Top to bottom 180°
212 Right to left 180°
213 Top to bottom 90°
214 Right to left 90°
221 Top 180°
222 Right 180°
223 Bottom 180°
224 Left 180°
225 Counter rotating top bottom
226 Counter rotating left right
227 Double rotating top bottom
228 Double rotating left right
231 V Open top
232 V Open right
233 V Open bottom
234 V Open left
235 V Open top bottom
236 V Open left right
241 Rotating top left
242 Rotating bottom left
243 Rotating bottom right
244 Rotating top right
245 Rotating top left bottom right
246 Rotating bottom left top right
251 Rotating top left right
252 Rotating left top bottom
253 Rotating bottom left right
254 Rotating right top bottom
261 Rotating double center right
262 Rotating double center top
263 Rotating double center top bottom
264 Rotating double center left right
409 Random effect (One of the 133 SMPTE effects is chosen at random)
503 Random radial (One of the 39 SMPTE radial effects is chosen at random)


© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |